home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / X11 / XDrawString.z / XDrawString
Encoding:
Text File  |  1998-10-30  |  4.2 KB  |  133 lines

  1.  
  2.  
  3.  
  4.      XXXXDDDDrrrraaaawwwwSSSSttttrrrriiiinnnngggg((((3333XXXX11111111))))  XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))   XXXXDDDDrrrraaaawwwwSSSSttttrrrriiiinnnngggg((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XDrawString, XDrawString16 - draw text characters
  10.  
  11.      SSSSYYYYNNNNTTTTAAAAXXXX
  12.           XDrawString(_d_i_s_p_l_a_y, _d, _g_c, _x, _y, _s_t_r_i_n_g, _l_e_n_g_t_h)
  13.                 Display *_d_i_s_p_l_a_y;
  14.                 Drawable _d;
  15.                 GC _g_c;
  16.                 int _x, _y;
  17.                 char *_s_t_r_i_n_g;
  18.                 int _l_e_n_g_t_h;
  19.  
  20.           XDrawString16(_d_i_s_p_l_a_y, _d, _g_c, _x, _y, _s_t_r_i_n_g, _l_e_n_g_t_h)
  21.                 Display *_d_i_s_p_l_a_y;
  22.                 Drawable _d;
  23.                 GC _g_c;
  24.                 int _x, _y;
  25.                 XChar2b *_s_t_r_i_n_g;
  26.                 int _l_e_n_g_t_h;
  27.  
  28.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  29.           _d         Specifies the drawable.
  30.  
  31.           _d_i_s_p_l_a_y   Specifies the connection to the X server.
  32.  
  33.           _g_c        Specifies the GC.
  34.  
  35.           _l_e_n_g_t_h    Specifies the number of characters in the string
  36.                     argument.
  37.  
  38.           _s_t_r_i_n_g    Specifies the character string.
  39.  
  40.           _x
  41.           _y         Specify the x and y coordinates, which are
  42.                     relative to the origin of the specified drawable
  43.                     and define the origin of the first character.
  44.  
  45.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  46.           Each character image, as defined by the font in the GC, is
  47.           treated as an additional mask for a fill operation on the
  48.           drawable.  The drawable is modified only where the font
  49.           character has a bit set to 1.  For fonts defined with 2-byte
  50.           matrix indexing and used with _X_D_r_a_w_S_t_r_i_n_g_1_6, each byte is
  51.           used as a byte2 with a byte1 of zero.
  52.  
  53.           Both functions use these GC components: function, plane-
  54.           mask, fill-style, font, subwindow-mode, clip-x-origin,
  55.           clip-y-origin, and clip-mask.  They also use these GC mode-
  56.           dependent components: foreground, background, tile, stipple,
  57.           tile-stipple-x-origin, and tile-stipple-y-origin.
  58.  
  59.           _X_D_r_a_w_S_t_r_i_n_g and _X_D_r_a_w_S_t_r_i_n_g_1_6 can generate _B_a_d_D_r_a_w_a_b_l_e,
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXDDDDrrrraaaawwwwSSSSttttrrrriiiinnnngggg((((3333XXXX11111111))))  XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))   XXXXDDDDrrrraaaawwwwSSSSttttrrrriiiinnnngggg((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.           _B_a_d_G_C, and _B_a_d_M_a_t_c_h errors.
  75.  
  76.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  77.           _B_a_d_D_r_a_w_a_b_l_e
  78.                     A value for a Drawable argument does not name a
  79.                     defined Window or Pixmap.
  80.  
  81.           _B_a_d_G_C     A value for a GContext argument does not name a
  82.                     defined GContext.
  83.  
  84.           _B_a_d_M_a_t_c_h  An _I_n_p_u_t_O_n_l_y window is used as a Drawable.
  85.  
  86.           _B_a_d_M_a_t_c_h  Some argument or pair of arguments has the correct
  87.                     type and range but fails to match in some other
  88.                     way required by the request.
  89.  
  90.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  91.           XDrawImageString(3X11), XDrawText(3X11), XLoadFont(3X11)
  92.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.